package com.suzka.service;

import com.suzka.pojo.Customer;
import java.util.List;

/**
 * 客户服务接口，定义了对客户数据进行CRUD操作的方法
 */
public interface CustomerService {
    /**
     * 查询所有客户信息
     * @return 包含所有客户的列表，如果没有客户则返回空列表
     */
    List<Customer> findAll();

    /**
     * 根据ID查询单个客户信息
     * @param id 客户唯一标识符
     * @return 匹配的客户对象，如果未找到则返回null
     */
    Customer findById(Integer id);

    /**
     * 保存客户信息
     * @param customer 需要保存的客户对象
     * @return 保存成功返回true，失败返回false
     */
    boolean save(Customer customer);

    /**
     * 更新客户信息
     * @param customer 需要更新的客户对象，应包含有效的ID
     * @return 更新成功返回true，失败返回false
     */
    boolean update(Customer customer);

    /**
     * 根据ID删除客户
     * @param id 需要删除的客户ID
     * @return 删除成功返回true，失败返回false
     */
    boolean deleteById(Integer id);

    /**
     * 根据名称关键字搜索客户
     * @param keyword 用于搜索的名称关键字
     * @return 匹配的客户列表，如果没有匹配项则返回空列表
     */
    List<Customer> searchByName(String keyword);
}
